home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / zclear.z / zclear
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  67 lines

  1.  
  2.  
  3.  
  4. zzzzcccclllleeeeaaaarrrr((((3333GGGG))))                                                          zzzzcccclllleeeeaaaarrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      zzzzcccclllleeeeaaaarrrr - initializes the z-buffer of the current framebuffer
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd zzzzcccclllleeeeaaaarrrr((((vvvvooooiiiidddd))))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _n_o_n_e
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      zzzzcccclllleeeeaaaarrrr sets the z-buffer in the area of the viewport to the largest
  19.      positive z value supported.  When multisample is enabled, and multisample
  20.      buffers exist in the current framebuffer configuration in the current
  21.      drawmode, this value is equal to ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____MMMMSSSS____ZZZZMMMMAAAAXXXX)))).... Otherwise, it is
  22.      equal to ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____ZZZZMMMMAAAAXXXX)))).... Typically zzzzcccclllleeeeaaaarrrr is called prior to
  23.      rendering each frame.  If you intend to clear the color bitplanes as well
  24.      as the z-buffer, or if you require control of the value written to the
  25.      z-buffer, call cccczzzzcccclllleeeeaaaarrrr instead of zzzzcccclllleeeeaaaarrrr.
  26.  
  27.      Because only the normal framebuffer includes a z buffer, zzzzcccclllleeeeaaaarrrr should be
  28.      called only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  Also, the current z writemask
  29.      controls which z-buffer bitplanes are modified during zzzzcccclllleeeeaaaarrrr execution,
  30.      and screenmask, when it is set to a subregion of the viewport, bounds the
  31.      cleared region.  Other drawing modes, including polygon fill pattern,
  32.      stenciling, texture mapping, writemask, and z buffering, have no effect
  33.      on the operation of zzzzcccclllleeeeaaaarrrr.
  34.  
  35.      After zzzzcccclllleeeeaaaarrrr executes, the graphics position is undefined.
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      drawmode, getgconfig, scrmask, setpattern, stencil, texbind, wmpack,
  39.      writemask, zbuffer, zwritemask
  40.  
  41. NNNNOOOOTTTTEEEE
  42.      On the Personal Iris, for performance reasons, the z-buffer is not
  43.      physically cleared when zzzzcccclllleeeeaaaarrrr is called.  Z-buffering works as it
  44.      normally would unless an attempt is made to read back data from the z-
  45.      buffer.  In situations where this is necessary, cccczzzzcccclllleeeeaaaarrrr should be used
  46.      instead of zzzzcccclllleeeeaaaarrrr.  When using cccczzzzcccclllleeeeaaaarrrr, the z-buffer will be physically
  47.      cleared to the specified value, if the specified value is in the range
  48.      -0x800001 to 0x7ffffe.
  49.  
  50.      For performance reasons, XS, XS24, XZ, Elan and Extreme products do not
  51.      physically clear the z-buffer when calling zzzzcccclllleeeeaaaarrrr.  On these systems, the
  52.      LSB of the z-buffer is used as a flag bit to signal that the z-buffer has
  53.      been cleared.  The 23 remaining bits are used for the z comparison.  In
  54.      order to physically clear the z-buffer, first call zzzzffffuuuunnnnccccttttiiiioooonnnn((((ZZZZFFFF____AAAALLLLWWWWAAAAYYYYSSSS)))),
  55.      then draw a polygon whose z coordinates map to the desired z value.  To
  56.      avoid updating the framebuffer, call wwwwmmmmppppaaaacccckkkk((((0000)))) before drawing.  Restore
  57.      the writemask and z function afterwards.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.